home *** CD-ROM | disk | FTP | other *** search
/ MacFormat UK 88 / MF_UK_88_1.iso / Shareware Plus / Utilities / FoldersSynchronizer 1.8.3 / Read Me < prev    next >
Encoding:
Text File  |  2000-01-26  |  20.5 KB  |  233 lines  |  [TEXT/ttxt]

  1.  
  2.  
  3.  
  4.  
  5. FoldersSynchronizer 1.8.3  - by Lorenzo Puleo, 26 January 1999
  6.  
  7. Shareware Utilities for Macintosh for Synchronizations or Backups. Choose two or more folders/disks and then they will be synchronized exaclty. The old files will be replaced with the newest files in both the directions. The new files (new entries) will be copied in both the directions, as well as the new Folders.
  8. The old Folders will not replaced entirely by the newer, as the Finder used to do, but their content will be updated with the newest files, the new files (new entries) and new Folders(new entries). 
  9. • FS can filter the documents to copy by Type, Creator and Modification Date.
  10. • FS can do multiple synchronizations or backups from your custom list. The user can save and load the lists.
  11. • FS can do synchronizations/backups at the time specified in the timer list.
  12. • FS can copy invisible Files and Folders.
  13. • FS can unlock the locked files, so the "exact backup" can delete also the locked files.
  14. • FS can save the Log File.
  15. • FS registered copies have no limits regarding the amount of files and folders or byte size. FS uses a buffer memory when copying, as well as the Finder used to do.
  16. • Scriptable by AppleScript.
  17. Be aware: FoldersSynchronizer cannot Undo the process. Before use it, try it on two trial folders in which there are subfolders and files. 
  18.  
  19.  
  20. Requirements for Macintosh:
  21. Power Macintosh (PPC version)
  22. MacOs 7.0.1 or higher (Tested also on MacOS 8 and 9)
  23. 7 Mb of free RAM
  24. 2.3 Mb free on disk
  25.  
  26.  
  27. What's new in the 1.8.3
  28. • In the previous versions, FS was not be able to delete folders with custom icon. In this version, FS can delete these folders.
  29. • When you pick a folder, FS will show you, as current folder, the parent folder of the last folder set.
  30.  
  31.  
  32. What's new in the 1.8.2
  33. • In the previous versions, if the check-box "Unlock locked files" was marked, FS unlocked all the locked files and leaved them in that state. In this version, FS unlocks the locked files just to do some tasks and then restores their original state.
  34.  
  35.  
  36. What's new in the 1.8.1
  37. • The Short Log Window now can show very long "Log Files".
  38.  
  39.  
  40. What's new in the 1.8
  41. • The Short Log Window can show both "Short Log" and the saved "Log Files" (if the check-box "Save Log File" in the Preferences area was marked). At the end of the sync or backup, click on the arrow which appears. Therefore the user can see the saved Log Files in this window directly, without using "SimpleText" application. At the bottom left of the Log Window there are two buttons: press the left button to see the ShortLog(s); press the right button to see the saved Log File(s). 
  42. • The Log Window is resizable and has vertical and horizontal bars. The vertical bar regards always the content of the Log Report. In case of multiple syncs/backups, the horizontal bar switches the single tasks. 
  43. • All the windows/dialogs can be closed by pressing the Command-W keys.
  44. • The preference file name is now "FoldersSynchronizer 1.8 Prefs".
  45.  
  46.  
  47. What's new in the 1.7.5
  48. • FS runs also on monitors less than 14" size. The minimum resolution requested is 360x360.
  49.  
  50.  
  51. What's new in the 1.7
  52. • FS can start BackUps and Synchronizations at the specified interval time (e.g.: every 1 hour and 20 minutes).
  53. You can set the interval by days, hours and minutes. You can also set the starting day and time.
  54. • FS can unlock the locked files, so the "exact backup", can delete also the locked files. Mark the check-box "Unlock locked files" in the Preferences area to allow FS unlocks the locked files.
  55. • AppleScripts can now manage the check-boxes of the Preferences area. See the file "Set Check-Boxes" inside the "AE Applet Samples" Folder.
  56. • The preference file name is now "FoldersSynchronizer 1.7 Prefs". As the previous versions, if you hold down the option key when launch FS (until the splash screen appears, and two seconds more), FS will skip the old 1.7 saved Preference file.
  57.  
  58. What's new in the 1.6.5 version
  59. • FS can copy also invisible Files and Folders.
  60. Go to the Preferences area and mark the check-box "Invisible Items" to let FS considers these items when working.
  61. • FS considers also files like "OpenFolderListDF" which have a Carriage Return at the end of the filename.
  62.  
  63.  
  64. What's new in the 1.6 version
  65. • FS can start BackUps and Synchronizations at the specified time.
  66. You can choose 7 timers specifying Hour, Minutes and the day of the week (on Monday, on Tuesday,... or Every Day).
  67. You have to leave FoldersSynchronizer open, if you want Syncs/Backups start automatically at the time specified.
  68. FS checks the timer list every 10 seconds (in multitasking mode), only if the "Timer On" check-box is marked and the current area is the consolle (the window with the 2 big arrows).
  69. If some error occurs, FS will stop the current task and will switch the Timer to off to prevent any next trouble.
  70. When you apply the timer list, FS will not consider, as today tasks, the today timers which are less or equal to the current system time.
  71. If the system is busy, FS will wait to take the control, then it will execute in background mode the syncs/backups not yet done.
  72. • There is a new menu "Option". It contains the menu items: Preferences, Filters, Multiple List, Timer.
  73. • The preference file name is now "FoldersSynchronizer 1.6 Prefs".
  74.  
  75.  
  76. What's new in the 1.5 version
  77. • FS can do multiple synchronizations or backups from your custom list. For now, max 7 synchronizations or backups are available at one time. Click on the blue "m" icon to set your multiple list.
  78. • FS saves and reloads your multiple lists.
  79. • FS shows the ShortLog window (by request) with multiple pages.
  80.  
  81.  
  82. What's new in the 1.4.2 version
  83. • Now FS works fine also with MacOS German version on old SCSI disks.
  84.  
  85.  
  86. What's new in the 1.4.1 version
  87. • In the "Info" area there is a new check-box: "Exact BackUp". If checked (only together with "One direction only"), FS will delete, from the Bottom Folder, all the Files and all the Folders that no longer exist in the Top Folder. 
  88. This way, the Bottom Folder will be an exact copy of the Top Folder, as the Finder has replaced the entire content of the Bottom Folder. 
  89. FS, which operates differently from the Finder, will copy only the Files and the Folders which really need to be copied, deleting in the Bottom Folder the Files and the Folders that no longer exist in the Top Folder, and therefore will take less time in the Finder. Moreover, the Filters can work together with this option. e.g. If you define a filter, FS will copy (or skip) and will delete (or skip) only those Files which match that filter.
  90. Use this option with care. THERE IS NO WAY TO UNDO THIS PROCESS!
  91.  
  92.  
  93. What's new in the 1.3 version
  94. • Some tasks run faster than previous versions (Scan Folders and Sync Files).
  95. • In the "Info" area there are two new check-boxes: "Beep when done" and "Save Log File".
  96. • The progress bar now appears as a 3D shadow standard Macintosh.
  97. • The "RegistrationFile.txt" has changed. The 1.x registered users can get the new "RegistrationFile.txt" free, by request to archidea@tin.it, specifying Registered Name and Email as they appear in the previous registered versions. No "RegistrationFile.txt" will send to different email addresses.
  98. • The preference file name is now "FoldersSynchronizer 1.3 Prefs"
  99.  
  100.  
  101. What's new in the 1.2 version
  102. • FS shows an infinite progress bar when it scans the folders looking for files to copy. So, when you apply some filters and FS scans a folder with many files but few files specified by filters, you can be sure that FS is working.
  103. • You can click also on the radio-button labels to activate them.
  104. • You can use the Enter, the Return and the Escape keys in the Filters area.
  105.  
  106.  
  107. What's new in the 1.1 version
  108. • The "RegistrationFile.txt" goes into the "PlugIn" folder. Please take your old "RegistrationFile.txt" from your old version and place it into the "PlugIn"  folder.
  109. • FS 1.1 can now filter the documents to copy by Type, Creator and Modification Date.
  110. See below the section "Use the filters".
  111. • If you hold down the option key when launch FS (until the splash screen appears, and two seconds more), FS will skip the old saved Preference file. In any case, the old preference file "SyncroPref10.txt" is no long considered by FS 1.1. You could also delete this file.
  112.  
  113.  
  114. Working with FoldersSynchronizer 1.8.3
  115. • Launch the application "FoldersSynchronizer".
  116. • Pick the 1st Folder by clicking on the Top Folder Icon.
  117. • Pick the 2nd Folder by clicking on the Bottom Folder Icon.
  118. • Click on button "Synchronize" to launch the process. You can stop the process at any time.
  119. • By clicking on the blue icon "i" at the bottom-right, you can set the check-box "Remember Folders" which allows FoldersSynchronizer to remember the last two Folder chosen, so you can avoid to pick the two folders  the next time you launch FS. This is recommended for advanced users (someone could synchronize two unwanted folders). It's most useful when you control this application by AppleScript. See below the Apple Scripts section.
  120. • The check-box "One direction Only" turns FoldersSynchronizer into a BackUp program. The big orange arrow on the left will change into a gray arrow. The Bottom folder will be upgraded with the newest files and folders
  121. coming from the Top folder, and the Top Folder will be left untouched.
  122. • Whenever FoldersSyncronizer meets conflicts between FolderNames and FileNames (e.g. it tries to copy the file "MyJob" into a folder in which there is the folder "MyJob"), it first renames automatically the FileName appending the suffix ".1", ".2", ".3", .etc, and then it copies the file. Even if the file is coming from the source folder during a BackUp, it will be renamed. So, before when we said "the Top Folder will be left untouched", we meant no deleting or movement.
  123. • Remember that FoldersSyncronizer cannot revert the process. There is not UNDO command. Therefore, to prevent any troubles, use this application with care.
  124. • At the end of the process, if the check-box "Save Log File" is marked, FoldersSyncronizer saves a Text Log File into the folder "Log Files" which describes each task done and a summary of files copied, replaced or renamed and Folders created for both the main folders chosen. FS will create the folder "Log Files", if it's needed. The filename of the Log file shows e.g. Bckp_1999_09_23_00_10_05. The format is "Bckp" for BackUps, "Sync" for Synchronizations. After, the date and time, YYYY_MM_DD_HH_MM_SS (Year, Month, Day, Hours, Minutes, Seconds).
  125. • If during the synchronization or BackUp an error occurs (e.g. a file is write-protected and FS cannot overwrite it), FS will advise you by an alert-box showing which file or folder is causing trouble, and will stop the entire process. At the bottom of the Log file, you will find the line in which the error occurred (e.g. Error copying file "MyDisk:Jobs:myFile" into "Server:BackUp:Jobs:myFile). Solve your problem (e.g. the disk is full or the file is locked) and then re-launch the process.  FS restarts from the first item, but will quickly skip the items already updated.
  126. • The user can stop the entire process by clicking on the button "Stop". The file Log will report this action by the user.
  127. Again, you can re-launch the process. FS restarts from the first item, but will quickly skip the items already updated.
  128. • FS has not limits about quantity of files and folders and byte size (it uses a buffer memory copying file by file as the Finder uses to do), so you don't need to increase the partition memory even if you have million of files/folder to sync or backup.
  129. • Do not modify, move or rename the "PlugIn" folder.
  130.  
  131.  
  132. Using the Filters
  133. • Since FS 1.1, you have been able to FILTER your documents to copy. Click on the blue icon "f" at the right of the console to go to the filters area.
  134. • Click on the check-box "Filter on" to active the filter window.
  135. • Click on the icon "File" to import Type and Creator from a file chosen in only one step.
  136. • Click on the single cell (Type or Creator) to import only the Type or only the Creator.
  137. • Hold down the option key and click to erase the single cell.
  138. • Hold down the option key and click on the "File" icon to erase Type and Creator in only one step.
  139. • You can also erase all the cells in only one step by clicking on the "Little Trash" icon.
  140. • Click on the cell "On" (first column at left) to activate/deactivate the single filter. The inactive filters will be shown grayed out.
  141. • You can choose to copy only the documents that match the filters list, or skip them and copy all of the rest.
  142. e.g. If you want to copy all the documents in your folders, but not the applications, pick the "Type" from any application ("APPL") and mark the radio-button "Skip only..." (it thinks: if you find an application, don't copy it, skip it - copy the rest)
  143. • Always click to the button "Apply" to confirm your changes to the filters list and filters preferences.
  144. • When you come back to the console and the filters are on, the blue icon "f" will change in light green/blue, so you can always tell when the filters are on. 
  145. • If you want to copy only the files with a modification date you specify, click on the cell "Date" to set the date. By default, FS will insert the operator ">=" (all the files with the modification date greater than or equals to...). You could "rotate" the 5 operators (>, >=, =, <=, <) by clicking on the cell "Op.". To delete the date, hold down the option key and click on the cell "Date".
  146. • Every single row is ONE filter and its parameters work as an "AND" combination. For example (the "Copy only..." radio button is marked): "Copy the files only if the Type is "TEXT" AND the Creator is "ttxt" AND the
  147. Modification Date is equal to 29 sept 1999". FS will copy ONLY the files whose satisfy ALL of these conditions .
  148. If only one of this condition is not satisfied, FS will not copy the file.
  149. • If you specify more than one filter, every filter works as explained above,  but you add an "OR" combination between filters. E.g.: if the first filter doesn't match the file, but the second filter yes, FS will copy the file.
  150. E.g. If you want to copy all the TIFF type plus all the today's files (TIFF and not TIFF...), you have to specify 2 filters:
  151. 1st filter: Type = TIFF
  152. 2nd filter: Date = Today (dd mmm aaaa)
  153.  
  154.  
  155. Apple Events
  156. • AppleScript can manage the process. See the 3 samples into the "AE Applet Samples" folder included in this package.
  157. Try to substitute the folders paths with your folders paths.
  158.  
  159.  
  160. Disclaimer
  161. • The authors of this software make no warranties, either express or implied, regarding the fitness of this or any version of FoldersSynchronizer for any particular purpose. Use FoldersSynchronizer at your own risk. The authors accept no liability for data loss or other problems caused directly or indirectly by FoldersSynchronizer.
  162. • The author is not responsible for any damage regarding lost data, damage of the archives, and any other trouble coming from the use of this software. The user, accepts these terms.
  163.  
  164.  
  165. Suggestions
  166. • Please, feel free to send to me your wish list and suggestions about FS's features to my email-boxes:
  167. archidea@tin.it  (or) puleo@kagi.com
  168. Any suggestion coming from the users could be implemented in the next releases. 
  169.  
  170. ----------------------------------------
  171. About Pricing:
  172. "FoldersSynchronizer" has the following pricing:
  173. 1-5 single user licenses, $20 per user (US Dollars)
  174. 6-9 single user licenses, $18 per user
  175. 10 or more single user licenses, $17 per user
  176.  
  177. A Site License costs $400 and covers all locations for your organization within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the software. 
  178. A World-Wide License costs $1600 and it covers all locations for your organization on the planet earth.
  179.  
  180.  
  181. About Registration:
  182. Paying for the FoldersSynchronizer is fairly simple. There are two methods. On the Web (quick, easy and secure payment on-line) and by "Register" application (off-line).
  183.  
  184. • To register on the web:
  185. Go to the web page http://order.kagi.com/?U3S
  186. 1 - Fill the form with your name, email, address, and how many copies you want.
  187. 2 - Click on the button "Continue" and it will appear the invoice form.
  188. 3 - Fill the fields regarding you Credit-Card datas and then click on the button "Purchase". That's all.
  189. Don't forget to include your email address. If you have not got one, send your friend's email address.
  190. We cannot accept orders without your email, because we can only send the "RegistrationFile.txt" by email.
  191.  
  192. If your browser supports, you can switch on SSL secure payment form (it's the internet international standandard secure form of payment).
  193. Kagi will send to you your approved invoice, in round 3 days (usually less than one day). One day after you will receive by me via Email a little TextFile ("RegistrationFile.txt") to put inside the "Plugin" folder (which is into the "FoldersSynchronizer" folder). I use to send the "RegistrationFile.txt" within 24 hours, so if you haven't heard anything most likely you have given us an Invalid Email Address.
  194.  
  195. • To register FoldersSynchronizer off-line by the "Register" application:
  196. You need the "Register" application that accompanies "FoldersSynchronizer" package.
  197. If you lost the "Register" application, you could download it (51Kb) from http://space.tin.it/arte/lpuleo/download/register.sit
  198. Launch the "Register" application, enter your name, email address and the number of single user licenses or other licenses you desire.
  199. Save or copy or print the data from the Register program and send the data and payment to Kagi.
  200. Kagi handles my payment processing. See the end of this document for more specific payment information.
  201. The fastest way (round 3 days) is to save the invoice to a text file, choosing "via email", and therefore send that text file via email as attachment to sales@kagi.com . You can also open the invoice text file with an editor (e.g. SimpleText) select all the text, copy and paste into the email so as it is (without any changement). Don't forget to include your email address. We need to send to you the RegistrationFile by email. We cannot accept orders without email, because we can only send the "RegistrationFile.txt" by email.
  202. Kagi will send to you your approved invoice, in round 3 days (usually less than one day). One day after you will receive by me via Email a little TextFile ("RegistrationFile.txt") to put inside the "Plugin" folder (which is into the "FoldersSynchronizer" folder). I use to send the "RegistrationFile.txt" within 24 hours, so if you haven't heard anything most likely you have given us an Invalid Email Address.
  203.  
  204.  
  205. Detailed Payment Info:
  206. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number. 
  207.  
  208. Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 10 days and if you provide a correct internet email address you will receive an email acknowledgement. 
  209.  
  210. If you are paying with Cash or USD Cheque you should print the data using the Register application and send it to the address shown on the form, which is: 
  211.  
  212.     Kagi
  213.     1442-A Walnut Street #392-U3S
  214.     Berkeley, California 94709-1405
  215.     USA
  216.  
  217. You can pay with a wide variety of cash from different countries but at present if you pay via cheque, it must be a cheque drawn in US Dollars. Kagi cannot accept cheques in other currencies.
  218.  
  219. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with their payment. 
  220. Kagi can not invoice your company, you need to act on my behalf and generate the invoice and handle all the paperwork on your end. 
  221.  
  222. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed.
  223.  
  224. Payments send via postal mail take time to reach Kagi and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi when the form is processed.
  225.  
  226.  
  227. --
  228. For further informations about the software:
  229. Lorenzo Puleo - Email: archidea@tin.it   -   puleo@kagi.com
  230. Web Site: http://space.tin.it/arte/lpuleo
  231.  
  232. For further informations about the payment:
  233. Kagi - Email: sales@kagi.com  - Web Site: http://www.kagi.com